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What IS PS/2? 


Old protocol for mice and keyboard 
: Still used in most laptops 
e Low bandwidth 
e Only allows for two finger multitouch 
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Why is it still used? 
e: Designed when PS/2 was the only option 
e Older versions of Windows still need it 


e Mouse support in UEFI (PS/2 doesn't need special 
drivers) 
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Alternatives 


PC: Used by Chromebooks, some Dells 


e RMI4/SMBus: Supported by Lenovo ThinkPads and 
some HP notebooks. Linux support is a WIP. 


e Not widely used, but some laptops have them 


4 © redhat. 


PS/2 in the kernel 


The basic PS/2 protocol for mice 
Each packet is 11 bits 


e Payload is 8 bits 


e Packets are sent in groups of 3 for normal 3 button mice, 
groups of 4 for mice with 5 buttons 


e There are some commands you can send: 
OxFF - Reset the mouse 
OxFE - Resend 
OxF6 - Set defaults 


Etc. 
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The basic PS/2 protocol for mice 


Bit 7 bito Bit5 bit4 Bit3 Bit2 Bit 1 BitO 


Figure 3-2. PS/2 relative motion packet 
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Problems with PS/2 


* 18042 controllers are picky, reject anything that isn't 
PS/2 


e Some even modify packets 
e Can't do absolute positioning, pressure, etc. 
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Working around PS/2 


PS/2 alone wasn't sufficient for touchpads 
e Manufacturers made their own protocols over PS/2 
e Add more information into PS/2 packets 
e Looks like normal PS/2 events to the 18042 
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Example of a packet from 
SynPS/2 


Bit / Bit © Bit 5 Bit4 Bits Bit 2 Bit l BitO 


wasa | o [wai] Rift | Let 
Y position 11..8 X position 11..8 
Z pressure 7..0 


ar [iren] c [Was] re | 


Figure 3-4. PS/2 absolute X/Y/Z/W motion packet (Wnode = 1) 
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Working around PS/2 


* Touchpads don't use extended protocols by default, 
so they work without special drivers 


e Activated with special command sequences 
“ For Synaptics: OxE8 (set sample rate) with the two 


bit argument containing part of the special 
command 
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Working around PS/2 


For some touchpads, PS/2 is a secondary protocol 
(e.g. RMI4) 

e Doesn't always get the same QA testing 

e Quirks for these touchpads are very common 

e Quirks both in the protocol and the touchpad 
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ps2emu 


psżemu 


A new thing | made! 


“< My intern project at Red Hat 

e Allows us to record PS/2 devices 

e Recordings can be replayed on other machines 
e Lets us reproduce bugs in PS/2 drivers locally 

e Has helped fix various bugs in touchpad drivers 
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os2emu 
* Two commands: 
* ps2emu-record: Records the PS/2 devices 
* ps2emu-replay: Replays the PS/2 devices 
e One kernel module: 


e userio: Allows for userspace to create virtual serio 
ports to communicate to the kernel with 
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os2emu-record 
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psżemu File Format 
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Demonstration! 


Limitations of ps2emu 


Doesn't emulate a touchpad, just repeats whatever 
is in the log 


Interaction between driver and ps2emu must be the 
same as the log 


Recordings may not work between kernel 
versions 
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Red ression tests? 
No working solution yet 


* ps2emu-replay isn't enough for this, we need to be 
Smarter 


e Must not break whenever the driver changes 
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Regression tests? 

e Mapping TouchPad registers: 
Not all TouchPads expose registers 
Complex 
Need every register value or it won't work 
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Regression tests? 
* Emulating a TouchPad 
e Very complex 
Dummy device might be prone to bugs 
Need one recording for each TouchPad 
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Summary 
PS/2 
Most common protocol in use for touchpads 
e Old, very backwards compatible 
c Transparent to the i8042 
Manufacturer specific protocols 
* ps2emu 
Records and replays PS/2 devices 
Potential for regression tests 
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Links 


1) Diagrams of packet layouts taken from 
Synaptics PS/2 TouchPad Interfacing Guide 
http://www.synaptics.com/sites/default/files/511-000275-01 Re 
vB.pdf 


e ps2emu userspace tools available here: 
Git: https://github.com/Lyude/ps2emu 


Fedora copr: 
https://copr.fedoraproject.org/coprs/lyude/ps2emu-tools/ 


e userio available here: 
Git: https://github.com/Lyude/ps2emu-kmod 
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